home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / sfsendsd.zip / SFSENDSD.DOC < prev   
Text File  |  1991-03-23  |  6KB  |  181 lines

  1.                               SFSENDSD
  2.                         (SPITFIRE SEND SPEED)
  3.                             Version 1.6
  4.                         Written By Mike Woltz
  5.                         Buffalo Creek Software
  6.  
  7.  
  8.     INTRODUCTION
  9.     ------------
  10.        
  11.        SFSENDSD is a utility written in Turbo Assembler and written to be
  12.     used in conjunction with a SPITFIRE Bulletin Board System to determine
  13.     the baud rate of a caller (by reading SFDOORS.DAT, SFMAIN.DAT, SFFILE.DAT
  14.     or SFMESS.DAT) and then pass an corresponding ERRORLEVEL to DOS.  An
  15.     example of using SFSENDSD is the usage of SPITFIRE as a door program
  16.     within SPITFIRE. In such case, once SFSENDSD has passed the ERRORLEVEL
  17.     to DOS, then SF.BAT can execute the correct commands to run the second
  18.     copy of SPITFIRE (see the below example).  The exact baud rate must be
  19.     passed as a parameter when using a second copy of SPITFIRE.  Refer to
  20.     the SPITFIRE manual for additional details on passing the baud rate
  21.     to SPITFIRE.
  22.     
  23.  
  24.     SETUP
  25.     -----
  26.  
  27.        If SPITFIRE is to be run as a door then the necessary commands to
  28.    execute the second copy of SPITFIRE must be included in the SF.BAT file.  
  29.    Let's assume you wish to run a second copy of SPITFIRE in a directory
  30.    path C:\SF\SUBSF as Door A. You would need to set your SF.BAT file up
  31.    to look similar to this:
  32.    
  33.      :DOOR_A
  34.        COPY SFDOORS.DAT C:\SF\SFSUBSF
  35.        CD\SF\SUBSF
  36.        SFSENDSD
  37.        IF ERRORLEVEL 193 GOTO 19200E
  38.        IF ERRORLEVEL 192 GOTO 19200
  39.        IF ERRORLEVEL 145 GOTO 14400E
  40.        IF ERRORLEVEL 144 GOTO 14400
  41.        IF ERRORLEVEL 97 GOTO 9600E
  42.        IF ERRORLEVEL 96 GOTO 9600
  43.        IF ERRORLEVEL 73 GOTO 7200E
  44.        IF ERRORLEVEL 72 GOTO 7200
  45.        IF ERRORLEVEL 39 GOTO 38400E
  46.        IF ERRORLEVEL 38 GOTO 38400
  47.        IF ERRORLEVEL 49 GOTO 4800E
  48.        IF ERRORLEVEL 48 GOTO 4800
  49.        IF ERRORLEVEL 25 GOTO 2400E
  50.        IF ERRORLEVEL 24 GOTO 2400
  51.        IF ERRORLEVEL 13 GOTO 1200E
  52.        IF ERRORLEVEL 12 GOTO 1200
  53.        IF ERRORLEVEL 4 GOTO 300E
  54.        IF ERRORLEVEL 3 GOTO 300
  55.        IF ERRORLEVEL 1 GOTO THISEND
  56.        GOTO THISEND
  57.        :38400
  58.          SPITFIRE 38400 /N
  59.          GOTO THISEND
  60.        :19200
  61.          SPITFIRE 19200 /N
  62.          GOTO THISEND
  63.        :14400
  64.          SPITFIRE 14400 /N
  65.          GOTO THISEND
  66.        :9600
  67.          SPITFIRE 9600 /N
  68.          GOTO THISEND
  69.        :7200
  70.          SPITFIRE 7200 /N
  71.          GOTO THISEND
  72.        :4800
  73.          SPITFIRE 4800 /N
  74.          GOTO THISEND
  75.        :2400
  76.          SPITFIRE 2400 /N
  77.          GOTO THISEND
  78.        :1200
  79.          SPITFIRE 1200 /N
  80.          GOTO THISEND
  81.        :300
  82.          SPITFIRE 300 /N
  83.          GOTO THISEND
  84.        :38400E
  85.          SPITFIRE 38400 /E /N
  86.          GOTO THISEND
  87.        :19200E
  88.          SPITFIRE 19200 /E /N
  89.          GOTO THISEND
  90.        :14400E
  91.          SPITFIRE 14400 /E /N
  92.          GOTO THISEND
  93.        :9600E
  94.          SPITFIRE 9600 /E /N
  95.          GOTO THISEND
  96.        :7200E
  97.          SPITFIRE 7200 /E /N
  98.          GOTO THISEND
  99.        :4800E
  100.          SPITFIRE 4800 /E /N
  101.          GOTO THISEND
  102.        :2400E
  103.          SPITFIRE 2400 /E /N
  104.          GOTO THISEND
  105.        :1200E
  106.          SPITFIRE 1200 /E /N
  107.          GOTO THISEND
  108.        :300E
  109.          SPITFIRE 300 /E /N
  110.          GOTO THISEND
  111.        :THISEND
  112.        CD\SF
  113.        GOTO LOOP
  114.      :DOOR_B
  115.  
  116.        As you might well be able to see, SFSENDSD determines the baud rate
  117.     the user is calling at and then issues an ERRORLEVEL to DOS for that 
  118.     particular baud rate.  The batch file uses the ERRORLEVEL to invoke the
  119.     appropriate SPITFIRE command line parameter.
  120.  
  121.        The below listed chart shows which ERRORLEVEL represents which baud
  122.     rate.  You will notice that SFSENDSD also recognizes whether the initial
  123.     connection is an error correction type connection and sends an ERRORLEVEL
  124.     accordingly therefore making the YModem-g protocols available when
  125.     appropriate.
  126.  
  127.                           BAUD RATE         ERRORLEVEL
  128.                           ---------         ----------
  129.                             LOCAL ............. 0
  130.               .DAT file not found ............. 1
  131.                               300 ............. 3
  132.               Error Checker   300 ............. 4
  133.                              1200 ............ 12
  134.               Error Checker  1200 ............ 13
  135.                              2400 ............ 24
  136.               Error Checker  2400 ............ 25
  137.                              4800 ............ 48
  138.               Error Checker  4800 ............ 49
  139.                              7200 ............ 72
  140.               Error Checker  7200 ............ 73
  141.                              9600 ............ 96
  142.               Error Checker  9600 ............ 97
  143.                             14400 ............144
  144.               Error Checker 14400 ............145
  145.                             19200 ........... 192
  146.               Error Checker 19200 ........... 193
  147.                             38400 ............ 38
  148.               Error Checker 38400 ............ 39
  149.  
  150.  
  151.     DISTRIBUTION
  152.     ------------
  153.  
  154.        SFSENDSD is distributed under the shareware concept.  You are
  155.     free to distribute the SFSENDSD program as long as it remains
  156.     unmodified and no fee is charged.  If you continue to use this 
  157.     program after an adequate evaluation period a fee is required.
  158.     A $0.25 fee is required of registered SPITFIRE sysops and a 
  159.     $ 5.00 fee is required of those who are not registered users
  160.     of SPITFIRE.
  161.  
  162.  
  163.     DISCLAIMER
  164.     ----------
  165.  
  166.        Mike Woltz and Buffalo Creek Software shall not be held
  167.     responsible for any damage incurred by the user to hardware,
  168.     software or peripheral devices while running SFSENDSD.  All
  169.     responsibility lies with the user of the software.
  170.  
  171.  
  172.        The documentation for SFSENDSD is contributed by Jacque
  173.     Shipley and The Mother Board BBS.  The shareware version of
  174.     SPITFIRE and other SPITFIRE utilities are available for download
  175.     from:
  176.  
  177.          Buffalo Creek's BBS              The Mother Board BBS
  178.           Mike Woltz, Sysop               Jacque Shipley, Sysop
  179.            (515) 225-8496                    (515) 986-3464
  180.     38400/19200/9600/2400/1200 Baud        9600/2400/1200 Baud
  181.